CASBOARD 2048 
The Flexi-Board System 
Copyright i984, all rights reserved 


DY 
kurt A. Casby 


First of all, thank you for your patronage. I hope, and believe, that you wiil find 
CASBOARD 2068 an exceptional value. Please take the time to read this documentation 
through, as there are many features and options you will not be able to take advantage of 


unless you do. If you have any questions not answered in this documentation, or 
experience any problems, please feel free to contact me. i 


Qn Compuserve: - ID# 72676,2544 
or : 
kurt A. Casby 
25 Battle Creek Court 
st. Paul, MN, 39119 


The Pitch 


CASBOARD 2068 is a full featured BBS program allowing for uploading, downloading, and 
multiple message bases. File transfers may be made using ASCII, HEX, or XMODEM orotocal. 
It runs using 8 bit word size, No parity, and 1 stop bit. Virtually every aspect of the 
program has been designed for easy modification and alteration by you, the sysop. A good 
BRS should have a personality of its own. With the flexablility of CASBOARD 2048 the 
only limitation to the personality of your BBS will be your own imagination! 


There may be, in the future, revisions of this program depending on you, the customer. 


if you find some feature lacking, or want specific modifications made, lèt me know. I 
will try to help, and if what you want is desired by many, ʻI will release a new version 
for any who want it. Your cost for any such revisions will be my cost. I have no 
intention of making anyone buy the same program more than once!. If you wish- to be 


notified of any such revisions, send your name and address to me at the above address. 


‘Three Versions Be ee oe at 


There are three versions of the BASIC portion of CASBOARD 2068.on the side of the 
cassette marked: "RES’, They are titled: "TAPE", "A&J", and "DISK". Use the one that 
fits your mass storage system. There is only one version of the machine code portion of 
the program, and it is on the side of the cassette marked: ‘CODE’. The tape version 
lacks the upload, download, and multiple message base capabilities, since they are 
impractical with a tape storage system. The disk version was written on and for a Zebra 
FOD disk system. It should, however, be easy to modify for ANY mass storage system that 
uses no RAM above 26710 (the start of BASIC), and is able to load and save ‘Bytes:’ 
files, i : 
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‘Setting Up 


You will need a minimum of three cassette sides, wafers, or disk sides for your working 


System. GQne for your backup, one for the working BES program, and one for your message 
base(s) and other files. You may also wish to backup the message base(s), and will need 
additional media for that. Tf you are using a dual {or more) drive system, ‘additional 


media will, obviously, be needed for that also. The BES program (BASIC and machine code) 
use about 8k, and the message bases ifor disk or wafer) use just under 28k (28,450 bytes 
Bach), so select your wafer accordingly! You can alter the size of the message bases if 
you wish, making them smaller or islightly) larger. This size was chosen so that 3 bases 
would fit on one 30 foot wafer, or 5 bases on one disk. The tape version message base is 
larger, but its size may also be easily changed if you wish. 


After formatting your disks, wafers, or whatever, follow these steps to set up your HBS. 
(You should read the remainder of the documentation BEFORE you set up!) 


1) Load the BASIC version of your choice. Each version is saved (and verified) twice on 
the cassette. First "TAPE", then "A&d", and lastly "DISK". Once loaded, the BASIC will 
auto-start in order to load the machine code. Since the machine code is on the other 
side of the tape, you will have to turn the tape over at this point. When both the BASIC 


and the machine code have been loaded, the program will stop with the report: 7 Siur 
statement, 9998:1. 


2) Make whatever modifications, alterations, and customizations you wish. (I told you 
that you should read the remainder of the docs first!) I suggest you start out with only 
a few modification, and build from there! 


3) Make a backup copy of your customized BRS by typing: SAVE "backup": SAVE "“bucode” 
COUDE 63360,2174. When you want to make further modifications, without starting from 
scratch, you will need this backup, as the working BBS program DELETEs some of the lines 


(lines only needed to set up variables etc., excess baggage once running!) when it is 
loaded. 


4) Make your working copy of the BBS by typing: RUN 9999, 


The Sysop s Menu 


When you load the working BBS it will auto-run, loading in the machine code, initializing 
lots of variables, and leaving you at the Sysop’s menu. Tt is from here that you will 
‘control the day to day operation of the BBS. Each function you may perform is listed on 
this menu, with the appropriate keypress highlighted in inverse video, You may enter 
these commands in upper or lower case, either will be accepted. If you. ever want to 
*break* the program, just hit cap-shift 6 at the Sysop’s Menu. GOTO 2 to re-start! 


‘Teoday’s Date: To set the date you press ‘T* and you will be prompted for the date. 
You may enter the date any way you wish, ifor example, 09/31/84) you do not have to enter 


it spelled out as I did. 


SUe/L=? This is the toggle switch for whether or not user’s uploads are allowed. 
Pressing “U* will toggle from Y to N, or back. See the notes titled: ‘About Uploads’. 


cD /L=7 This is the toggle for whether or not downloads are permitted. See the notes 
titled: ‘About Downloads’. 


ciePassword= Pressing *!’ prompts you for the new password. 
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(#2 Pressing *“#° allows you to create a new message base, 
¿Ü ptions: Pressing ‘O° allows you to alter the options for the current message base. 
The options you may choose from are: 


R/W Message base can be written to and read from by the users. 

R/Q Message base can be read from, but not written to by the users. 

W/Q Message base can be written to, but not read from by the users. 

scroll? Y or WN controls whether or not the oldest messages scroll off as new 
messages are added to the message hase. If scroll is set to N, then if the message 
base fills all the way up, no new messages can be added by the users. 


Please note that these settings affect only what the users of your BBS can do, not what 
yOu, aS sysop, can do. 


¿Load Message Base presents menu of message bases for your choice, and loads the one 
you select. 


{Seave Message Base saves the current message base, overwriting any old message base 
with the same name. | 


¿Print Message Base prompts for bulletin or messages, then prints which ever you select 
on the printer. All of the messages are printed out if you select messages. 


(Veiew Message Base prompts for bulletin or message, then prints which ever you select 


on the screen. If you allow long messages, or if you select scroll, they will scroll 
rather quickly by! Pressing either “Caps Shift’ key will pause the scrolling as long as 
you hold it down. After each message, you will be prompted for *Scroll, Next, or Quit’. 


You actually have 3 options here, pressing: 


will scroll the messages by, not stopping between each message. 
(or just ENTER) will continue with the next message. 

will quit to the Sysop’*s Menu. 

will delete the message you just read. 

will print the message you just read on the printer. 


TO 2 y 


Enter Message Base Bulletin allows you to enter the bulletin for that message base. 
Let your text (and words) wrap around, pressing ENTER only at the end of each paragraph. 
It may look funny when you type it, but it will be properly formatted when you, or one of 
your users, read it. Not only does this approach save memory, but it allows the text to 
be properly formatted for your user’s screen, whatever width it is. Press °STOP’ (symbol 
shift A) when you are finished typing the bulletin. 

‘Worite a Message prompts you for ’To:’, and *Re:*, then lets you type in yOur message. 
Flease follow the same typing rules outlined above. Press “STOF* {symbol shift A) when 
yOu are finished typing your message. 


¿F orce Chat Mode when you interupt one of your users on line, you have two options, put 
them in chat mode, or hang up on them. Pressing `F? will force the user into chat mode. 
Press STOP to end chat mode. 


CHeang up hangs up the phone, and activates the BBS. If a user is aon line, this will 
hang up on him/her. To get back to the Sysop*s Menu, press STOF. 


tHising the BRS 


The normal daily routine for “firing up the BBS’ has been made very easy. (At least that 
was my intent!) It consists of only four steps: 


1) Load the working BBS. 
2} 5et the date. 
3) Load in a message base. 


4) Hang up to activate the EBS. Press STOP to get back to the Sysop’s Menu at any time. 
Even when a user is on line, pressing STOP will bring you to the Sysop’s Menu. Tf you 


interupt a user in the middle of something, ‘upload, download, entering a message etc.) 
their work will be lost. So be careful when you interupt someone! 


The First Time 


The first time you use the BBS things are a little more complicated, but hopefully, not 
too much more complicated! You should still set the date first, as it is automatically 
appended to any messages you write to the message base, and you must write at least one 
message in each base, You must then create your message base‘s), as you have none to 
load! Follow these steps: 


I) Load the working BBS. 

2) Set the date. 

3) Press the asterick (#) key to create a message base. 

4) Select title of the one you wish to create from the menu presented. 


3) Answer the prompts about the message base options (Read/Write, Read/Only, or 
Wreite/Only, and Scroll Y/N) setting them to your wishes. 


#6) IMPORTANT: You will now be back at the Sysop’s Menu. You must finish the creation 
process by writing at least one message to the base ‘see “Message entry’ in ‘Sysap"s 
Menu’), Do this BEFORE doing anything else. Many of the routines expect ta find at 
least one message in the base, so this is mandatory! Flease also note that you should 
never delete all of the messages in a base. Always leave at least one! If you want to 
erase an entire message base, just re-create it! 

Make any other additions you wish (more messages, your message base bulletin, etc.) 
then save the message base by pressing 's? at the Sysop’s Menu. 


7) 


8) Hang up to activate the BBS. Note that the BRS will not answer the telephone when you 
are at the Sysop’s Menu. Pressing STOF will always return you to the Sysan’s Menu. 


‘Customization 


Before we get too heavily into this area, let me make this perfectly clear: you do not 
need to modify, or alter anything if you don’t want to! The BRS will run just fine the 
Way it was delivered, This section is for those who want to make their BBS unique, or 


give it a personality’. 
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You do not need extensive knowledge of BASIC to customize the program, only enough to 
recognize DATA statements, and string assignments. You should, however, keep the screen 


Width in mind when you make the modifications. I suggest that you. format your changes 
for your screen (no more than 31 characters). I also suggest that you run the BBS a 
while with only minimum alteration. You will have a better idea after that of what you 


want to change! 


Print a listing of the BASIC, or list it on your Screen, and we’ll take a backwards walk 
through it, stopping to explain what the lines do, make whatever changes you want in the 
program as we gūi. 


9999 Saves the program and machine code for your working BBS. 
90900--9005 Contains the variable assignments for most of the prompts, as well as other 
Variables. Some examples of what you might want to change: 
of holds the system password 
y$ holds the sysop’s name or “handle’ (Your name or handle!) 
df holds the date iChange it from the Sysop’*s Menu!) 
o$ holds the default settings for the options 
xf holds the list of acceptable’ answers to the Main Menu’s prompt 
c$ holds the list of ‘acceptable’ answers to the Sysop’*s Menu prompt 
r$ holds a carriage return 
t$ holds two carriage returns 
nf will hold the name of the BBS’s user 
b$ will hold the title of the current message base 
af, ef, ff, gt, k$, 1, m$, gf, vt, and wt hold various prompts 
bs holds the starting address of the message base 


You may change the size of the message base by changing the variable *bs’*, but you must 
also change the ‘CLEAR’ statement in line 9900 accordingly. 

1000-4000 There are four sets of DATA statements (3 in the tape version) starting at line 
1000, 2000, 3000, and 4000. These are, in order, the ‘Welcome’ message or screen, the 
Main Menu for the BBS, the Message Base Menu, and the Download Menu. Each of these sets 
has the same ‘format’, which you must abide by. The first item of data is the number of 
data items which follow that should be sent as a-line of text. This is followed by that 
number of data items plus one. The one extra is treated as a prompt. In other words, 
that last data item is sent, then the program waits for an answer. These DATA statements 
do not have to be on separate lines, I put them that way in an attempt to make this 
“format” more clear, but you may change that if you wish. 


FOr example, the set of DATA statements starting at line 1000 sends out the four data 
items, then uses g$ (Password=) as a prompt, waiting for an answer. Note also that by 
using r$, or t$, or both, one DATA item may be more than one line on the screen. To 
alter this, just enter your data items, count them up, and place the number of them in 
the first data item. While this may sound difficult, it is not! 


178-2530 (235 for TAPE) contains the code for running the BES while on line. Take a look 
through it, you will see several more prompts that are sent under certain circumstances. 


Line £50 (233 for TAPE) contains the signoff message. 


225 (220 for TAPE) contains the beep? loop for when someone wants to chat with you. 
Pressing any key when someone pages you will put you in chat mode. 


76-197 Contain various subroutines. Look through them, as some of them contain prompts. 
2-7? Contains the code for running the BBS from the Sysop’s Menu. 
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The LOAD and SAVE statements (if you need to change them for your mass storage system) 
are in lines: 9999, 7900, 238, 2335, 175, and 1466. 


When you add more message bases to the list in line 3000+, you will also have to edit 
line 221 changing the “Highest” from `B? (or ‘2° for A&d) to whatever your new highest 


The printer output is set for the T&2040 printer. Tf you want to use a full size 
Printer, you must have printer driver software that reconfigures the printer channel. 
This software must also ‘live’ somewhere under address 24710, Many printer drivers are 
available that live in the printer buffer. These should work just fine. I have been 
using John Qliger’s printer driver software with my Aerco Centronics interface, but other 
interfaces and software are available from various dealers. You can alter the length of 
the line printed out (from 32) to whatever you wish by changing lines 45 and 48. Edit 
the line where it says PORE rn-1,CODE “ ", and change the " " to "R" for 80 characters 
per line, or use the character (instead of R) that has the code equal to the characters 
per line you desire. In line 68, POKE rn-i, CODE " " occurs twice. Change only the 
first one! If your printer requires linefeeds as well as a carriage return, FOKE 
addresses 64257 and 64274 with 10, 


The maximum size for a message is 254 times the number in address 463544. (This does not 
include the DATE, TO, FROM, etc) The current maximum size is set to 512 byes. If you 
PRINT PEER 63546, you should see a 2, but you may alter this as you see fit. Please note 
that this only defines the maximum size a message can be, not how much space each message 
takes. Messages are stored so that they take only their actual length in memory. 


i realize that we have covered a lot of ground here, in a rather brief section of the 
documentations. I believe, however, that if you play? with it a little, you will find 
these notes sufficient and the BBS fairly easy to alter. Like programs, most 
documentations are not perfect. If I have left some gap unfilled, let me know and I711 
do my best to fill it in for you. If it becomes obvious that I left something out of 
these instructions, I will mail any updates I make to any of you who’s name and address I 
have. I want you to have fun with your BBS, not spend your life trying to get it to work 
the way you want! After all, didn’t you buy it for fun? 


‘Ab out Downloads 


To allow downloads from your BBS, you must do three things: 


i) Set the D/L toggle to Y. 


2) Put the name of the file in the download list. (DATA statements starting at 4000) 
Then check line 221 to see that the range of ‘acceptable’ answers is correctly set. 


3) Save the file on the disk or wafer with your message baseis). Name it “D?” where the 
question mark is replaced with the letter (DISK) or number {A&3)} that is referenced on 
the menu line in the DATA statements. ; 


Bil files for downloading must be ‘Bytes: files. Tf you want to make a BASIC program 
into download file, load the program, then type: . 
LET x=PEER 23627 + 256 * PEEK 23428: SAVE “D?” CODE 24710,x-26719 then press ENTER. 


Flease note that a download file cannot be larger than the message base in size. You 
~ be 


should also put a description of the file in a message, or a message base bulletin. Your. 
user can choose which method to use for download, ‘only text can be sent using ASCII). 


‘About ploads 


Allowing uploads is the most dangerous thing you can’do as a sysop. I would suggest that 
you only allow uploads at certain times, when you are available to keep an eye on the 
system. The reason for this caution is that if someone uploads a file, and there is not 
enough space on your disk/wafer, the whole show will come to a stop. It has also been my 
Ghservatian that most files uploaded without prior approval tend to be junk! it is gli 
up to you, but bear in mind my cautions. 


a allow uploads to your BRS you must do two things: 


i) Set the U/L toggle to Y. 


2) 


2) Have sufficient room on your disk/wafer to accept files. 


If you are running with A&d, you will also have to set the variable u equal to the number 
Gf files already on your water. If, for example, you have message bases 1 and 2, and two 
files on the wafer for downloading {a total of four files), you would LET u=4. You can 
make this change in line 7000, if you will be running all the time with the same number 
of files, or change it on the fly by pressing shift 6 at the Sysop’*s Menu to stop the 
program, then typing LET u=4 and hitting ENTER, then GOTO 2. 


Any files uploaded will be saved to your disk/wafer as "U?", where the ? is the number of 
uploads since you fired up. (Plus the number of files already on the wafer for A&J). I 
know all this sound complicated, but once you ‘play’ with it a little, you will find it 
very easy. Also note that the count starts over everytime you fire up. 


Now that you’ve got the upload on your disk/wafer, what do you do with it? First look at 
it to see if it is something you want at all. Then do what you want with it, rename it 
as a download for others to share, erase it if its junk, resave it to a different disk or 
wafer if it is not something you want on the BRS, or whatever! I would suggest that you 
ask anyone uploading to leave a message describing what they uploaded, so you will know 
where to start! If it is a text file, or machine code, then it is already in the correct 
format, ‘“Bytes:*. If it is a BASIC program, then it will have to be re-converted from a 
"Bytes: * file to a ’Program:’” file. Please note, however, that if you want ta leave it 
on the BBS as a download it is in the right format! 


To re-convert a BASIC program so that YOU can look at it and use it, for to find the 
length of any uploaded file) follow these steps: 


i) From the Sysop’s Menu, press shift 4 to stop the program. 
2) Type: CLEAR 63350: RANDOMISE USR 463726 then press ENTER. 
3) Load the file into memory (LOAD "U?" CODE) 

4) Type: RANDOMISE USR 65466 then press ENTER 


You will now be looking at the listing of the uploaded program. (The length of the file 
Will be recorded for you in lo/hi byte format at address 63530, and 63531, so PRINT PEEK 
63530 + 256 * PEEK 43531 will tell you the length of the file.) You may save’ it, run it, 
or whatever you want to do with it. If you have several uploads to convert, then save it 
But don’t run it now, as you may repeat steps 2 to 4 to convert your other uploads. 

I realize that this may sound difficult, but once you’ve tried it a few times you will 
find that it goes very quickly for you. 
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